Retry-After header

Der HTTP-Retry-After-Antwort-Header gibt an, wie lange der Benutzer-Agent warten sollte, bevor er eine nachfolgende Anfrage stellt. Es gibt drei Hauptfälle, in denen dieser Header verwendet wird:

  • In einer 503 Service Unavailable-Antwort zeigt er an, wie lange der Dienst voraussichtlich nicht verfügbar sein wird.
  • In einer 429 Too Many Requests-Antwort gibt er an, wie lange gewartet werden soll, bevor eine neue Anfrage gestellt wird.
  • In einer Weiterleitungsantwort, wie etwa 301 Moved Permanently, zeigt er die Mindestzeit an, die der Benutzer-Agent abwarten soll, bevor die umgeleitete Anfrage gestellt wird.
Typ des Headers Antwort-Header
Verbotener Anfrage-Header Nein

Syntax

http
Retry-After: <http-date>
Retry-After: <delay-seconds>

Direktiven

<http-date>

Ein Datum, nach dem erneut versucht werden soll. Siehe den Date-Header für mehr Details zum HTTP-Datumsformat.

<delay-seconds>

Eine nicht-negative Dezimalzahl, die die Sekunden angibt, die nach Erhalt der Antwort verzögert werden sollen.

Beispiele

Umgang mit geplanter Ausfallzeit

Die Unterstützung für den Retry-After-Header ist bei Clients und Servern noch uneinheitlich. Einige Crawler und Spider, wie der Googlebot, beachten jedoch den Retry-After-Header. Es ist nützlich, ihn zusammen mit einer 503-Antwort zu senden, damit Suchmaschinen Ihre Website weiter indexieren, wenn die Ausfallzeit vorbei ist.

http
Retry-After: Wed, 21 Oct 2015 07:28:00 GMT
Retry-After: 120

Spezifikationen

Specification
HTTP Semantics
# field.retry-after

Browser-Kompatibilität

Siehe auch